home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / tftd.arc / TFTD.DOC < prev    next >
Encoding:
Text File  |  1990-02-18  |  6.5 KB  |  121 lines
  1.                           Thought For The Day
  2.                                 (TFTD)
  3.           Copyright, 1987-1990, Jim Perry, All Rights Reserved.
  4.  
  5.           
  6.                         L E G A L  S T U F F
  7.                         ────────────────────
  8.                         
  9.        There are no guarantees associated with this program, either 
  10.     expressed, or implied.  The end user of TFTD assumes all 
  11.     responsibility, and liability, for it's proper operation and 
  12.     usage, and, by using TFTD, agrees that the author is blameless, 
  13.     should anything yucky happen to your machine, as a result of your 
  14.     usage of TFTD.  There is no fee requested for the usage of TFTD, 
  15.     and it may be freely copied & given away, as long as this 
  16.     documentation, and the program itself, is not modified in any way. 
  17.     The program itself remains the copyrighted work of the author.
  18.           
  19.           
  20.                             H I S T O R Y
  21.                             ─────────────
  22.                            
  23.                            
  24.        Thought for the Day (TFTD), was originally written in 1987, by 
  25.     me, for me.  I like to remember a lot of different quotes, by 
  26.     various people, and this was a way for me to do that.  The first 
  27.     revsion of TFTD was in TP 3.01, and was really limited in what it 
  28.     could do, and what it expected for a quote file.  This version 
  29.     doesn't suffer from those failings, and represents the first time 
  30.     that I feel TFTD is ready to "go public".  TFTD is now written in 
  31.     TP 5.5, and is much faster, and a lot more user friendly than it's 
  32.     predecessors.
  33.     
  34.                            O P E R A T I O N
  35.                            ─────────────────
  36.                          
  37.        TFTD expects to find two files when it runs, the quote file, 
  38.     (TFTD.DAT), and it's index file, (TFTD.IDX).  First, the quote 
  39.     file.  TFTD.DAT is a plain ASCII file of quotes you'd like 
  40.     displayed.  Each quote has no set number of lines, and is 
  41.     terminated by a blank line, that is, a line with nothing on it, 
  42.     except a CR/LF pair (/x0d/x0a).  There is an upper limit on total 
  43.     number of quotes, but it's sufficiently up there, that you should 
  44.     never have problems.  If you want TFTD to display a blank line, 
  45.     make sure there is at least one space character (/x020) on that 
  46.     line.  If not, TFTD will see the line as a delimiter for that 
  47.     particular quote.  The first line of the quote file must not be 
  48.     blank, and  the last line of the quote file needs to be a blank 
  49.     CR/LF terminated line.  I know, kinda strange, but that's the way 
  50.     it is!
  51.     
  52.        The index file (TFTD.IDX) is created whenever 1)TFTD can't find 
  53.     an index file, or 2) the quote file has a later time/date stamp 
  54.     than the index.  In general, you don't ever need to worry about 
  55.     the index, TFTD will handle that by itself.
  56.     
  57.        TFTD expects to find the aforementioned files in the directory 
  58.     where it was executed from.  For example, if you have TFTD in 
  59.     C:\UTILS, then TFTD will look for it's quote & index files in that 
  60.     directory.  It never looks in the local directory, unless, of 
  61.     course, that's where it was executed from.  I did this for several 
  62.     reasons.  One of them being, I don't have to do a lot of file 
  63.     presence/absence checking, which slows operation down.  I also 
  64.     don't have to rely on an environment variable to be set to find 
  65.     the quote file.  The only drawback to this methodology, is that is 
  66.     only good under MS/PC-DOS 3.0+.  It will not work under DOS 2 or 
  67.     less.  Sorry 'bout that, but if you're using DOS 2 in 1990, you 
  68.     need to 1)get a life, and 2)get DOS 3.3 or better!
  69.     
  70.                       B B S  O P E R A T I O N
  71.                       ────────────────────────
  72.                    
  73.        TFTD is also designed to work with most BBS systems, rather 
  74.     seamlessly, I think.   I use QuickBBS 2.63, and it has the 
  75.     capability to display various files to users when they log on. I 
  76.     wanted to be able to shoot a quote at a user when he logs on, 
  77.     without having to run some sort of door that takes 5 minutes to 
  78.     load and display a 1-line quote.  To have TFTD put it's quote in a 
  79.     file, give it the following command-line parameters:
  80.     
  81.        TFTD <path\file> /s"Header to display before quote"
  82.        
  83.        The path & file is simply a fully qualified path and filename 
  84.     where you want TFTD to place it's output.  The /S parameter is 
  85.     text that you would like displayed before the quote.  For example, 
  86.     on my system, I use the following command-line:
  87.     
  88.   TFTD d:\quick\text\news.asc /s"Here's your thought for the day, #6W"
  89.   
  90.        The first is the path to my news file, and the second displays 
  91.     the quoted text as a header in front of the quote.  The #6 is a 
  92.     Ctrl-F (/x06) that, when followed by a W, displays the user's 
  93.     first name, when this particular file is displayed.  If you want 
  94.     to put in any characters that are not in the range of 32-126 
  95.     decimal, you need to preface that particular character with the # 
  96.     character, and then enter the ASCII code for that given character. 
  97.     This will tell TFTD that you want a non-printing char put in the 
  98.     header line.  If you have embedded spaces(or tabs) in your desired 
  99.     header line, the whole line must be enclosed in quotes, as shown 
  100.     above. This method of routing a quote to a text file will allow 
  101.     almost any BBS system to use TFTD in it's daily operation.  
  102.     
  103.                         L A S T  N O T E S
  104.                         ──────────────────
  105.                         
  106.        I've included my quote file for you to get started with, feel 
  107.     free to add or delete from it, at your pleasure.  I do ask that if 
  108.     you distribute this archive, you include the original quote file, 
  109.     as I've distributed it.  Be warned, that there are some quotes in 
  110.     the file that might be offensive to some!  None are vulgar, it's 
  111.     just that a few poke fun at some American sacred cows.  If you 
  112.     have any good quotes, feel free to drop me a message, I can be 
  113.     reached at Fidonet 1:375/10, USR HST, 24hrs/day.
  114.     
  115.       Compliments, suggestions, attaboys   > Jim Perry, 1:375/10
  116.       Complaints, flames, bad vibes >NUL
  117.     
  118.                                         Jim Perry
  119.                                         Montgomery, Al
  120.                                         February, 1990
  121.